API

状态码列表及说明

客户端向 SuperMap iManager服务器发送HTTP请求时，SuperMap iManager 服务器会根据请求的类型返回响应结果，通过响应结果中的状态码，客户端可以得知请求的处理情况。例如：是否成功、出错的原因，等等。

HTTP 协议定义了各个状态码代表的意义，官方定义有41种状态码，分5类，如下：

• 1xx：信息性——收到请求，继续处理
• 2xx：成功性——成功收到、理解并接受行动
• 3xx：重定向——必须采取进一步行动来完成请求
• 4xx：客户端错误——请求包含错误语法或不能完成
• 5xx：服务器错误——服务器没有成功完成显然有效的请求

SuperMap iManager 主要用到其中的2xx 系列、4xx 系列和5xx 系列，各个状态码的含义如下表所示：

状态码值	含义
200	表示服务器成功执行了客户端的 HTTP 请求。如果请求的类型是 GET 说明获取资源成功，是 PUT 说明修改资源成功，是 DELETE 说明删除资源成功，是 HEAD 说明获取资源的元数据成功。
201	表示服务器按客户端的请求成功创建了一个新资源。对应的请求类型是 POST 或 PUT。注意，这时返回的信息中会包含 Location 报头，指向新创建资源的规范 URI。
400	表示客户端的请求参数不合法或没有表达足够的信息。
401	表示因为安全的原因，导致对资源的操作没有完成。
404	表示客户端请求的资源不存在，即 URI 无效。
405	表明资源不支持该操作。
406	表示资源不支持客户端请求的表述格式。
500	表示服务器端发生非预期情况，导致请求没有完成。